Format 函数

返回 一个 Variant (字符串) ，其中包含 表达式 格式表达式中包含的指令设置格式的字符串。

警告    使用此函数时存在问题。 某些日历年的最后一个星期一可以返回为第 53 周，该周应为第 1 周。 有关详细信息和解决方法，请参阅 Format 或 DatePart 函数可能返回年份中最后一个星期一的错误周数。

请参阅一些示例

语法

format ( expression [ ，format ] [， firstdayofweek ] [ ， firstweekofyear ] )

Format函数语法具有以下参数：

参数

说明

expression

必需。 任何有效的表达式。

格式

可选。 有效的命名或用户定义格式表达式。

firstdayofweek

可选。 一 常量 指定一周的第一天。

firstweekofyear

可选。 一个常量，指定一年的第一周。

设置

format 参数可以使用各种设置，具体取决于表达式数据类型参数的表达式值。 有关有效格式表达式详细信息，请参阅下表中列出的文章。

对于使用此函数的数据类型...

请参阅文章

任何类型

Format 属性

日期/时间

设置日期和时间字段的格式

数字

设置数字或货币字段的格式

文本和备忘录

设置文本字段的格式

是/否​​

Format 属性 - Yes/No 数据类型

firstdayofweek参数具有以下设置：

常数

值

说明

vbUseSystem

0

使用 NLS API 设置。

VbSunday

1

星期日 (默认)

vbMonday

2

星期一

vbTuesday

3

星期二

vbWednesday

4

星期三

vbThursday

5

星期四

vbFriday

6

星期五

vbSaturday

7

星期六

第 一个weekofyear 参数具有以下设置：

常数

值

说明

vbUseSystem

0

使用 NLS API 设置。

vbFirstScript1

1

从 1 月 1 日 (星期开始) 。

vbFirstFourDays

2

从一年的第一周开始，该周至少有四天。

vbFirstFullWeek

3

从一年的第一个整周开始。

备注

设置格式

执行此操作

数字

使用预定义的命名数字格式或创建用户定义的数字格式。

日期和时间

使用预定义的命名日期/时间格式，或创建用户定义的日期/时间格式。

日期和时间序列号

使用日期和时间格式或数字格式。

字符串

创建自己的用户定义的字符串格式。

如果尝试设置数字格式而不指定格式，则Format提供的功能类似于Str函数，尽管它是国际感知的。 但是，使用 Format 格式化为字符串的正数不包括为值符号保留的前导空格;那些使用 Str 转换的 保留前导空格。

如果要设置非本地化数字字符串的格式，则应当使用用户定义的数字格式以确保获得想要的外观。

注意: 如果 "日历 "属性设置为公历， 并且格式 指定日期格式，则提供的 表达式 必须是公历。 如果Visual Basic 日历 属性设置是回历，则提供的 表达式 必须是回历。

如果日历是公历，则格式 表达式 符号的含义保持不变。 如果日历是回历，则所有日期格式符号 (如 dddd、mmmm、yyyy) 具有相同的含义，但适用于回历。 格式符号保留为英语;导致文本显示符号的符号 (例如 AM 和 PM) 显示与该符号 (英语或阿拉伯语) 字符串。 当日历是回历时，某些符号的范围会更改。

符号

Range

d

1-30

dd

1-30

ww

1-51

mmm

显示回历月份名称 (回历月份名称没有缩写) 。

y

1-355

yyyy

100-9666

在表达式中使用 Format 函数    可以在任何 可以使用表达式 的地方使用格式。 例如，可以在查询中使用它作为字段别名的一部分，或在窗体或报表上文本框的"控件来源"属性中使用它。 以下示例演示了一个表达式，该表达式可能用于报表的 Filter 属性，以将输出限制为前一周的记录。

格式化 ([Date]，"ww") =Format (Now () ，"ww") -1

本示例中的报表记录源有一个名为"日期"的字段，其中包含每个特定记录的修改日期，该日期用于报表。 运行报表时，将筛选其结果，以仅显示"日期"字段中的值的周 (格式 ([Date]，"ww") ) 等于上一周 (格式 (Now () ，"ww") -1) 的记录。

在 VBA 代码中使用 Format 函数    

注意: 以下示例演示了在 VBA Visual Basic for Applications (模块) 函数。 有关使用 VBA 的信息，请在"搜索"旁边的下拉列表中选择"开发人员参考"，在搜索框中输入一个或多个术语。

此示例演示了 Format 函数的各种用法，它们使用命名格式和用户定义的格式来设置值的格式。 对于日期分隔符 (/) 、 时间分隔符 (：) 和 AM/PM 文本，系统显示的实际格式化输出取决于运行代码的计算机区域设置。 在开发环境中显示时间和日期时，使用代码区域设置短时间格式和短日期格式。 通过运行代码显示时，使用系统区域设置短时间格式和短日期格式，这可能与代码区域设置不同。 对于此示例，假定为美国英语区域设置。

MyTime MyDate 使用当前系统短时间设置和短日期设置在开发环境中显示。

将 Format 与零长度字符串一同使用

在 Microsoft Access 版本 2.0 及更早版本中，可以使用 Format 函数返回一个值作为 零长度字符串 ，为值返回另一个值。 例如，可以使用格式表达式（如下所示）和 Format 函数从代码中返回相应的字符串值：

在 Microsoft Access 版本 97 和更高版本中，必须单独测试 Null 大小写，然后根据结果返回相应的值。 例如，可以在表达式中将 IIf 函数与 Format 函数一起使用，如下所示：

varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))

此更改仅在使用 Format 函数根据字符串是零长度字符串还是 Null 值来设置字符串格式时适用。 与 Format 函数一 起使用的其他 格式表达式将继续像在以前的版本中一样工作。

如果将数据库从 Microsoft Access 2.0 和更早版本转换为 Microsoft Access 2002 或更高版本，则必须更改代码以单独测试 Null 大小写。

字符串函数以及如何使用它们